SGSetDataProc(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Configuring Sequence Grabber Components

SGSetDataProc
The SGSetDataProc function allows you to specify a data function for use by the sequence grabber. Whenever any channel assigned to the sequence grabber writes data, your data function is called as well. Your data function may then write the data to another destination.
pascal ComponentResult SGSetDataProc (SeqGrabComponent sg, 
                                       SGDataProc proc, 
                                       long refCon);
sg
Identifies your connection to the sequence grabber component.
You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.
proc
Contains a pointer to your data function. To remove your data function, set this parameter to nil. The interface that your data function must support is described in "Application-Defined Functions" beginning on page 5-107.
refCon
Contains a reference constant. The sequence grabber provides this value to your data function.

DESCRIPTION
Your application may use the SGSetDataProc function to assign a data function to a sequence grabber. The sequence grabber calls your data function whenever any channel component writes data to the destination movie. You may use your data function to store the digitized data in some format other than a QuickTime movie.

SEE ALSO
You can instruct the sequence grabber not to write its data to a QuickTime movie by calling the SGSetDataOutput function and setting the seqGrabDontMakeMovie flag to 1. This can save processing time in cases where you do not want to create a movie. This function is discussed beginning on page 5-24.